        Keithley Model 2010 DMM TestPoint Library
        -----------------------------------------

        Revision 2.0, Updated 5/9/96

        Users Notes:            

        The 2010 TestPoint Libraries K2010GV2.TST, KTH2010G.TST and 
        K2010SV2.TST are User Defined Objects that provide the user 
        with pre-defined actions that can be used to program the 2010 
        for a variety of functions. The K2010SV2.TST library is dedicated 
        for RS-232 Serial users. The KTH2010G.TST library is dedicated for 
        GPIB users and is compatible with TestPoint 1.1 and higher.
        K2010GV2.TST is a new library for the 2010 that is compatible
        with TestPoint 2.0 and higher. K2010GV2.TST contains improvements
        to the library not found in KTH2010G.TST. If you are currently
        using KTH2010G.TST, do not replace the library in your application
        with K2010GV2.TST unless you plan on changing your application.
        K2010GV2.TST is not a direct replacement for KTH2010G.TST

        For RS-232 users, the defaults are as follows:
        Com Port = 2
        2010 Baud Rate = 9600
        Hardware Handshake = No
        Xon,Xoff = Yes
        RS-232 Timeout = 40
        Output Queue Size = 1024
        Input Queue Size = 2048
        Should you wish to change the Com Port functions to something
        other than the defaults, double-click on the 2010 icon. You can 
        change the functions to the desired settings. Make sure that your
        2010 settings agree with what you choose, otherwise, errors will
        occur.


        For GPIB users, the default IEEE-488 address of the 2010 is set at 
        the factory for 16. The 2010 Library is set for the default address 
        of 16. Should you wish to change the 2010 library address to 
        something other than 16, double-click on the 2010 icon. You can 
        change the address to the specific address you wish to use.
        K2010GV2.TST also provides the capability to change the GPIB
        Timeout.

        The actions pre-defined for the 2010 Library are as follows:


        Open RS-232 Port              (Applies for K2010SV2.TST Only)
        Close RS-232 Port             (Applies for K2010SV2.TST Only)
        Reset 2010
        Get Reading                   (KTH2010G.TST Only)
        Get ASCII Reading             (K2010GV2.TST and K2010SV2.TST Only)
        Get Binary Reading            (K2010GV2.TST Only) 

        Data Buffer Operations =====> Setup Data Buffer
                                      Read Buffer        (KTH2010G.TST only
                                      Read ASCII Buffer  (K2010GV2.TST and
                                                          K2010SV2.TST only)
                                      Read Binary Buffer (K2010GV2.TST only) 
                                      Read Buffer Math
        One-Shot Measurement Function
        Configure Math Functions ===> Setup Math Functions
                                      Setup Buffer Math
        Limit Testing ==============> Setup Limits
                                      Re-perform Limit Test
                                      Clear Limits1 Failed Test
                                      Clear Limits2 Failed Test
                                      Get Limits1 Test Result
                                      Get Limits2 Test Result
        Display Control
        Setup Data Formats
        Scanner Functions ==========> Open All Relays
                                      Close Internal Channel
                                      Setup Scanner Function
        Configure / Set DMM ========> DC Volts ==>  DC Volts Settings
                                                    DC Volts Terminals
                                      DC Amps
                                      AC Volts
                                      AC Amps
                                      2-Wire Ohms
                                      4-wire Ohms
                                      Temperature=> Set for Thermocouple
                                                    Set for RTD's
                                                    Set Measurement Parameters
                                      Frequency / Period
                                      Diode / Continuity
        Triggering Functions =======> Setup Triggering
                                      Halt Triggering
                                      Start Triggering
        Set Measurement Units
        Set System Functions


        When creating your application, the 2010 Icon is dragged from the
        Object List into the Action List. When this process is performed,
        the above list of selections is provided. The user can then select
        the action to perform on the 2010. The actions are described below:

        
        'Open RS-232 Port'
         ----------------
        This action opens the selected RS-232 port, sets the baud rate, and
        sets up the Com Port for handshaking. These settings can be changed
        by double-clicking on the 2010 ICON. This action is available only
        in the KTH2010S.TST library.

        'Close RS-232 Port'
         -----------------
        This action closes the RS-232 Com Port. This action is available 
        only in the KTH2010S.TST library.


        'Reset 2010'
         ----------
        Reset sends the *RST command to the 2010. This action performs a 
        complete reset on the 2010 in compliance with the IEEE-488.2
        specification. *RST turns the Trigger Model completely off. To turn
        the Trigger Model back on, use the 'Start Trigger' action.
        Using Reset also programs the 2010 to return readings only, not 
        any of the other possible data elements such as Channel, Units,
        etc.


        'Get Reading'                   (KTH2010G.TST only)
         -----------
        Get Reading performs the action of reading a single value from the
        2010.


        'Get ASCII Reading'             (K2010GV2.TST and K2010SV2.TST only)
         -----------------
        Get Reading performs the action of reading a single value from the
        2010 using ASCII data transfer.


        'Get Binary Reading'            (K2010GV2.TST only) 
         ------------------
        Get Reading performs the action of reading a single value from the
        2010 using Binary data transfer.
        
        
        'Data Buffer Operations =====>   Setup Data Buffer'
         -------------------------------------------------
        This action sets up the data buffer to store data. The user can
        choose the buffer source of NONE, NEXT , or ALWAYS storing, the
        number of points to store up to 1024, and where the data will come
        from, either the INPUT, CALC block, or NONE.


        'Data Buffer Operations =====>   Read Buffer'   (K2010G.TST)
         -------------------------------------------
        Read Buffer returns the contents of the 2010's internal data buffer.
        A total of 1024 readings can be returned, along with other data such
        as the Channel Number and Units. This information had to be set 
        previously by using the 'Setup Data Formats' action. This action 
        can return up to 524,288 bytes.


        'Data Buffer Operations =====>   Read ASCII Buffer'   (K2010GV2.TST)
         -------------------------------------------------    (K2010SV2.TST)  
        Read Buffer returns the contents of the 2010's internal data buffer.
        A total of 1024 readings can be returned, along with other data such
        as the Channel Number and Units. This information had to be set 
        previously by using the 'Setup Data Formats' action. This action 
        can return up to 524,288 bytes.


        'Data Buffer Operations =====>   Read Binary Buffer' (K2010GV2.TST)
         --------------------------------------------------
        Read Buffer returns the contents of the 2010's internal data buffer.
        A total of 1024 readings can be returned, along with other data such
        as the Channel Number and Units. This information had to be set 
        previously by using the 'Setup Data Formats' action. This action 
        can return up to 524,288 bytes. Uses Binary Data Transfer.


        'Data Buffer Operations =====>   Read Buffer Math'
         ------------------------------------------------
        This action returns the results of any Math performed on the 
        internal data buffer.


        'One-Shot Measurement Function'
         -----------------------------
        This action allows the user to single shot the 2010 for any of the
        measurement functions supported in the 2010. It will set the 
        desired measurement function, then return a reading.


        'Configure Math Functions ===>   Setup Math Functions'
         ----------------------------------------------------
        This action allows the user to setup the 2010 for math operations.
        These operations include 'Percent' and 'mX+b'. The percent target
        value, the value of 'm' and 'b' are user selectable. Also, you can 
        set the units that will appear on the display when using the 'mX+b'
        function.


        'Configure Math Functions ===>   Setup Buffer Math'
         -------------------------------------------------
        This action allows the user to set up the 2010 to perform a math
        operation on the data stored in the internal data buffer. The math
        functions to choose from include Mean, Standard Deviation, 
        Maximum, Minimum.


        'Limit Testing ==============>   Setup Limits'
         --------------------------------------------
        This action allows the user to set the 2010 for limit testing. The
        user can set two levels of upper and lower limits.



        'Limit Testing ==============>   Re-perform Limit Test'
         -----------------------------------------------------
        This action re-performs a limit test.


        'Limit Testing ==============>   Clear Limits1 Failed Test'
         ---------------------------------------------------------
        This action clears a Limits1 failed indication.


        'Limit Testing ==============>   Clear Limits2 Failed Test'
         ---------------------------------------------------------
        This action clears a Limits2 failed indication.


        'Limit Testing ==============>   Get Limits1 Test Result'
         -------------------------------------------------------
        This action returns the result of the Limits1 test.


        'Limit Testing ==============>   Get Limits2 Test Result'
         -------------------------------------------------------
        This action returns the result of the Limits2 test.


        'Display Control'
         ---------------
        This action allows the user to put messages on the front panel
        display or completely turn the display off.


        'Setup Data Formats'
         ------------------
        This action allows the user to set the 2010 to return the data using
        either ASCII or binary data formats. Also, the user can select the
        type of reading information to be returned. The 2010 will always
        return a reading, but can be appended with the Channel Number
        and Units. ASCII only format available for KTH2010S.TST library.


        'Scanner Functions ==========>   Open All Relays'
         -----------------------------------------------
        This action opens all relays on an internal scanner card installed
        in the 2010.


        'Scanner Functions ==========>   Close Internal Channel' 
         ------------------------------------------------------
        This actions allows the user to close a specific channel on an 
        installed scanner card. The user can select a channel from 1 to 10.


        'Scanner Functions ==========>   Setup Scanner Function' 
         ------------------------------------------------------
        This action allows the user to select the scanner from NONE, 
        Internal, or External. If Internal is selected, a scan list can be
        defined for the 2010.


        'Configure / Set DMM ========>   DC Volts ==> DC Volts Setting'
         -------------------------------------------------------------
        This action allows the user to select the DC Volts measurement
        function. The user can set the resolution, measurement range, 
        autoranging, number of power line cycles for A/D integration, 
        filter count, Repeat or Moving filter type, and turning the 
        filter on or off.


        'Configure / Set DMM ========>   DC Volts ==> DC Volts Terminals'
         ---------------------------------------------------------------
        This action allows the user to select the DC Volts input terminals.
        The choices are NORMAL and SENSE for the terminals and either
        AUTORANGE or a specific range for the sense terminal inputs. In 
        Addition, the 2010 can be set up for ratio measurments.


        'Configure / Set DMM ========>   DC Amps'
         ---------------------------------------
        This action allows the user to select the DC Amps measurement
        function. The user can set the resolution, measurement range, 
        autoranging, number of power line cycles for A/D integration, 
        filter count, Repeat or Moving filter type, and turning the 
        filter on or off.


        'Configure / Set DMM ========>   AC Volts'
         ----------------------------------------
        This action allows the user to select the DC Volts measurement
        function. The user can set the resolution, measurement range, 
        autoranging, number of power line cycles for A/D integration, 
        filter count, Repeat or Moving filter type, and turning the 
        filter on or off. In addition, the user can select the AC Low
        Frequency Bandwidth of 3, 30, or 300 Hertz.


        'Configure / Set DMM ========>   AC Amps'
         ---------------------------------------
        This action allows the user to select the AC Amps measurement
        function. The user can set the resolution, measurement range, 
        autoranging, number of power line cycles for A/D integration, 
        filter count, Repeat or Moving filter type, and turning the 
        filter on or off. In addition, the user can select the AC Low
        Frequency Bandwidth of 3, 30, or 300 Hertz.


        'Configure / Set DMM ========>   2-Wire Ohms'
         -------------------------------------------
        This action allows the user to select the 2-wire Ohms measurement
        function. The user can set the resolution, measurement range, 
        autoranging, number of power line cycles for A/D integration, 
        filter count, Repeat or Moving filter type, and turning the 
        filter on or off. In addition, the user can also select an
        Offset Compensation measurement mode.


        'Configure / Set DMM ========>   4-Wire Ohms'
         -------------------------------------------
        This action allows the user to select the 2-wire Ohms measurement
        function. The user can set the resolution, measurement range, 
        autoranging, number of power line cycles for A/D integration, 
        filter count, Repeat or Moving filter type, and turning the 
        filter on or off. In addition, the user can also select an
        Offset Compensation measurement mode and a Dry Circuit mode.


        'Configure / Set DMM =====> Temperature => Set for Thermocouples'
         -------------------------------------------------------------------
        This action sets the 2010 for using thermocouples. The user can
        select the Thermocouple type including J, K, N, and T. The user can
        select the reference type, a simulated reference value, temperature 
        units, the Temperature Coefficient and Voltage Offset of a real
        reference junction.
        Simulated Reference Temperature Ranges: 
        C=> 0 to 50,  F=> 32 to 122,  K=> 273 to 323


        'Configure / Set DMM =====> Temperature => Set for RTDs'
         ----------------------------------------------------------
        This action sets the 2010 for using RTDs. The user can choose from
        PT100, D100, F100,PT3916, PT385, or a USER RTD. If you choose USER,
        the action then allows you to enter the RZERO, ALPHA, BETA, and
        DELTA of the USER RTD.


        'Configure / Set DMM =====> Temperature => Set Measurement Parameters'
         ---------------------------------------------------------------------
        This action sets measurement parameters when making temperature
        measurement. You can set the temperature resolution, integration rate
        (NPLC), filter count, Repeat or Moving filter type, and turning the 
        filter on or off. 



        'Configure / Set DMM =====> Set Frequency/Period Function'
         --------------------------------------------------------
        This action allows the user to set the 2010 for Frequency or 
        Period measurements. The user can set the Voltage Threshold Range,
        the frequency aperture, and the resolution.


        'Configure / Set DMM =====> Set Diode/Continuity Function'
         --------------------------------------------------------
        This action allows the user to choose between either a Diode 
        Measurement function or Continuity Measurement function. The user
        can set the Diode Current Range and the Continuity Threshold.


        'Trigger Functions =======> Setup Triggering'
         -------------------------------------------
        This action allows the user to set the various modes of triggering
        that the 2010 can use. Settable is the Trigger Source which includes
        Immediate, External, Timer, and Bus. The user can set the Trigger
        Count, Delay, Timer value, and Sample Count.


        'Trigger Functions =======> Halt Triggering'
         ---------------
        This action stops any triggering of the 2010 and places the 2010 in 
        the idle mode.


        'Start Triggering'
         ----------------
        This action is used to start the triggering process in the 2010. It
        takes the 2010 out of the idle mode.
        
        
        'Set Measurement Units'
         ---------------------
        This actions allows the user to set various engineering units for 
        the 2010. The user can set the AC or DC units to Volts, dB,
        or dBM. Also settable is the reference value used for the dB and
        dBM units. 


        'Set System Function'
         -------------------
        This action allows the user to set various system function of the
        2010. In particular, you can set the Auto-Zero function on or off,
        turn the internal beeper on or off, or turn the key-click on or off.



        =================================================================
        Notes:

        The K2010SV2.TST library for RS-232 is available from the Keithley
        Instruments BBS at 216-498-2786 in the TestPoint subconference, or
        can be found on Keithley's World Wide Web page in the FTP server.
        The Keithley URL is: www.keithley.com
        The Keithley FTP site can also be reached through:
                ftp://ftp.keithley.com/pub/instr

        As a reminder, the following files are compatible with the
        following versions of TestPoint:

        KTH2010G.TST  ==> Version 1.1 and higher
        K2010GV2.TST  ==> Version 2.0 and higher
        K2010SV2.TST  ==> Version 2.0 and higher


        DEMO MODE: Should the user wish to place the 2010 into the
        DEMO MODE, you can double-click the 2010 icon and check the DEMO 
        MODE box.

        Setup Data Format: The 2010 can return a variety of reading
        elements back to TestPoint. The 2010 will return more than just the
        reading if the reading elements controls have been set to 'Yes' or
        'On'. Sending *RST resets the elements back to Reading Element only.
        Beware of unwanted characters. TestPoint may display square 
        characters after the reading or in-between reading elements. These
        characters are hidden characters, generally carriage return and
        line feed characters, and perhaps commas. This mostly occurs when
        a TestPoint display is displaying numeric data, not string data. The
        KTH2010G.TST library was written such that the data is returned as 
        string data and the unwanted characters are removed for KTH2010G.TST. 
        K2010GV2.TST and K2010SV2.TST returns data as a Vector of String
        and Number if Binary data transfers are used.


        The library covers a large percentage of the 2010 operation but
        not 100% of all of the functions. Any function of the 2010 can be
        programmed using a GPIB object in your application and programmed
        directly. For further assistance on programming the 2010, you can
        contact any local Keithley office for technical assistance. In 
        addition, you can contact Keithley Instruments with your questions
        by browsing throught the Keithley World Wide Web page on the 
        Internet. The URL is:  http://www.keithley.com
        Your questions can be sent in the Applications subpage.

